home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / Disk Of The Month 26.adf / Doc-Files / Utilities.Doc < prev    next >
Text File  |  1988-06-19  |  52KB  |  1,142 lines
  1.  
  3. Utilities Docs
  5. This file includes Documentation for all files in the Utilities Drawer. They 
  6. have all been combined into one to save disk space.
  7.  
  8. The Docs included in this file are:
  10. Spread
  11. MemoPad
  12. DWIP
  13. KeyClick
  15. Doc File Headers are in RED!
  16.  
  17. *****************************************************************************
  18.  
  20.  
  21.     SPREAD - Tiny Amiga spreadsheet
  23.     Spread history (as if you care):
  24.  
  25.     This program grew from a notion I had, 4 years ago, that a
  26. spreadsheet would be a good tool to have, to help with certain jobs at
  27. the office. I had read about VisiCalc, and later Lotus 1-2-3, but I had
  28. never used a spreadsheet, so I designed Spread with few pre-conceived
  29. notions about how it should work. As far as I know, Spread bears little
  30. resemblance to any other spreadsheet.
  31.  
  32.     The first version of Spread was written to run on a PDP-11
  33. running RT11 or TSX, with a VT220 terminal. It was written in Decus C,
  34. it only supported fixed-12-character columns, and only what the screen
  35. could display. It was later enhanced to support a larger worksheet with
  36. scrolling, and to support a 132 column display. Spread is still used at
  37. the office almost use daily.
  38.  
  39.     When I found myself dialing in to work from my Amiga to use
  40. Spread fairly often (a long distance phone call too), I decided it was
  41. time to port the program over to the Amiga.
  42.  
  43.     The PDP-11 Spread used VT220 display controls and accepted VT220
  44. function keys. These are not completely compatible with the features of
  45. the Amiga CON: device, so I decided to re-write the user interface to
  46. make best use of the Intuition's input and output features.
  47.  
  48.     I started work on the Amiga version in early January 1988, and
  49. spent most evenings and weekends at the keyboard (my wife hated it). You
  50. have the result before you.
  51.  
  52.     Amiga Spread supports a few features the PDP11 version doesn't,
  53. specifically the ability of a text cell to overlay empty cells to the
  54. right, the ability to set the column width and decimals, it supports a
  55. larger worksheet (The PDP version must run in only 56K!), and of course
  56. the Intuition interface.
  57.  
  58.     Spread features:
  59.  
  60.     o Small 36 X 60 worksheet
  61.     o Four basic math functions, plus row and column summing
  62.     o Intuition-ized user interface
  63.     o Resizable Workbench window
  64.     o Absolute and symbolic cell references in formulas
  65.     o Worksheet editing: insert/delete row, insert/delete column
  66.     o Cell editing: cut, copy, paste, erase single cells
  67.     o Variable column width and decimal places
  68.     o Automatic or Manual recalculation
  69.  
  70.     Running Spread:
  71.  
  72.     Spread can be invoked from the CLI or launched from a Workbench
  73. icon. If launched from the Workbench, the Lattice C startup code will
  74. first open a standard input/output window, which Spread ignores. It is
  75. recommended that Spread be given a stack size of 8000. A larger stack
  76. size provides no benefit.
  77.  
  78.     If Spread is run from the CLI, you can include a command
  79. parameter specifying the name of a file which Spread will load as the
  80. current spreadsheet.
  81.  
  82.     The Spread window gives a display of (r) rows and (n) columns.
  83. The number of rows and columns depends on the current size of the
  84. display window, the width of the individual columns, and the narrow/wide
  85. font selection. The intersection of each line and column is called a
  86. cell. Cells may be empty, or they may contain text, or they may contain
  87. a formula.
  88.  
  89.     Spread currently supports 60 rows and 36 columns. This is very
  90. small by commercial product standards.
  91.  
  92.     In the window, one cell is displayed in reverse; this indicates
  93. the 'cursor'. The cursor may be moved using the arrow keys, or by
  94. pointing to a cell with the mouse pointer and clicking.
  95.  
  96.     If a movement would place the cursor on a cell which is not in
  97. the display window, the display is scrolled. The horizontal and vertical
  98. scroll bars also move the display window and the cursor.
  99.  
  100.     If a cell contains text, then the text is displayed in the
  101. window in that cell. If the text is wider than the current column's
  102. width, then the text will 'overflow' into empty cells to the right of
  103. the selected cell. If the text is so long that it would overflow into a
  104. cell that is occupied, then the text is truncated at that point.
  105.  
  106.     If a cell contains a formula, then the result of the formula is
  107. displayed in the cell in the window. Calculations are double precision
  108. floating point. The number display is initially 2 decimal places.
  109.  
  110.     The contents of a formula cell is a string in simple algebraic
  111. notation. It is evaluated according to the following rules:
  112. Multiplication ('*'), division ('/'), and modulo ('%') are performed
  113. first, from left to right; then addition ('+') and subtraction ('-')
  114. from left to right; then MAX and MIN left to right; then conditionals
  115. from left to right. The order of evauation can be forced by the use of
  116. parentheses.
  117.  
  118.     If you want a cell to simply contain a number, then make it a
  119. formula cell, and type in the number you want as the formula.
  120.  
  121.     Formula cells may be given logical names. The names can be
  122. referred to in other cells' formulas to call the value from the cell;
  123. this allows cell position changes within the display without affecting
  124. the logical sources for values in formulas. Only formula cells may be
  125. given names. The name must begin with a letter, and may contain
  126. letters and numbers. It may not contain spaces.
  127.  
  128.     Cell editing (text, formula, or name) is done in the string
  129. gadgets at the bottom of the window.
  130.  
  131.     When the cursor is on an empty cell, the entry gadgets at the
  132. bottom of the window are ghosted and cannot be selected. The "Cells"
  133. menu allows the choice of either a text cell or a formula cell. If
  134. "Cells/Edit Text cell" or "Cells/Edit Formula Cell" is chosen, then the
  135. cell type is chosen, the text gadget is enabled and activated, and the
  136. text may be entered immediately.
  137.  
  138.     When the cursor is on a text cell, the cell's text is placed in
  139. the text gadget. This gadget can be selected and the text modified.
  140.  
  141.     When the cursor is on a formula cell, the cell's formula and
  142. name are placed in the text and name gadgets. These can be selected and
  143. modified.
  144.  
  145.     If you wish to change a text cell to a forumla cell or vice
  146. versa, you must erase the current cell and define it anew. The menu
  147. entries "Edit/Cut" or "Edit/Erase" will erase the contents of a cell.
  148.  
  149.     Calculation can be set to automatic or manual. In automatic
  150. mode, whenever a formula cell is edited or any change which may effect
  151. the numeric results of other cells is performed, recalculation takes
  152. place. In manual mode, recalculation is done when the "Calculate/
  153. Evaluate" menu entry is selected, when the user presses the 'C' key, and
  154. upon loading a new spreadsheet from disk, and no other time.
  155.  
  156.     Calculation is done as follows: Each formula in the spreadsheet
  157. is solved, starting in cell R0C0 and moving down, then repeating for
  158. successive columns moving right. Cells which depend on other cells'
  159. values should be placed under or to the right of the cells which supply
  160. the values.
  161.  
  162.     If a cell must make a 'forward' reference, to a cell which will
  163. be calculated later in the spreadsheet, then calculating twice will
  164. usually result in the correct value.
  165.  
  166.     If a calculation can't be performed, the cell will display asterisks
  167. ('****.**') instead of a number. You should inspect your formula to see
  168. what is wrong. You may have left your parentheses unbalanced, or perhaps
  169. you refer to a cell name that you haven't defined. 
  170.  
  171.     Formulas
  172.  
  173.     Formulas are algebraic expressions similar to FORTRAN or BASIC
  174. expressions. Operations proceed left to right, according heirarchy
  175. (multiplication after addition, etc). Expressions may be grouped with
  176. parentheses.
  177.  
  178.     Values are included in an expression using the following
  179. notations:
  180.  
  181.     <value>    - a number, like '10', '-5', '2.34'
  182.     RmCn    - takes the value in the cell at row (m) column (n)
  183.           Special case, either (m) or (n) can be '.', which
  184.           means to use the current row/column
  185.     name    - takes the value in the cell with the given name.
  186.  
  187.     The following arithmetic operators are provided:
  188.  
  189.     +    Addition                p + q
  190.     -    Subtraction                p - q
  191.     *    Multiplication                p * q
  192.     /    Division                p / q
  193.     %    Modulo (remainder from division)    p % q
  194.     MAX    greater of two values            p MAX q
  195.     MIN    lesser of two values            p MIN q
  196.  
  197.     -    Negate                    -p
  198.     ABS    Absolute value                ABS(p), ABS p
  199.     INT    Extract integer portion            INT(p), INT p
  200.  
  201.     SUM    Sum of all cells in a row or column above/to the left of
  202.         the current cell. SUM's format:
  203.  
  204.         SUM(RmCn)
  205.  
  206.         'm' and 'n' can be:
  207.             a row/column number
  208.             '.' to specify the current row/column
  209.             '*' to specify all the rows/columns above/to
  210.                 the left
  211.         Any of the above formats for 'row' and 'col' can be
  212.         combined except R*C*, which is invalid.
  213.  
  214.     Conditional Binary operators; these are entered as binary
  215. operators (one operand on each side) and give the second operand if the
  216. conditional test on the first operand is true, otherwise they give zero:
  217.  
  218.     ?EQ    op = 0            7 ?EQ 3 = 0    0 ?EQ 3 = 3
  219.     ?NE    op not = 0        7 ?NE 3 = 3    0 ?NE 3 = 0    
  220.     ?GT    op greater than 0    7 ?GT 3 = 3    -7 ?GT 3 = 0
  221.     ?GE    op greater or equal 0    7 ?GE 3 = 3    -7 ?GE 3 = 0
  222.     ?LT    op less than 0        7 ?LT 3 = 0    -7 ?LT 3 = 3
  223.     ?LE    op less or equal 0    7 ?LE 3 = 0    -7 ?LE 3 = 3
  224.  
  225.  
  226.     Spread menu selections:
  227.  
  228.     "Project" Menu
  229.  
  230.     "Project/New": Erases the entire contents of the current
  231. spreadsheet.
  232.  
  233.     "Project/Load": Erases the entire contents of the current
  234. spreadsheet, then loads a previously-saved spreadsheet. This brings up a
  235. requester asking for the name of the file to load.
  236.  
  237.     "Project/Save": Saves the current spreadsheet into a file.
  238. Project/Save uses the same file name as the spreadsheet that was loaded,
  239. or if no file name has been specified, it puts up a requester asking for
  240. the name of the file to save to.
  241.  
  242.     "Project/Save as..": saves the current spreadsheet into a file.
  243. This puts up a requester asking for the name of the file to save to.
  244.  
  245.     "Project/Print": prints to a file a displayable image of the
  246. current spreadsheet. This puts up a requester asking for the name of the
  247. file to print to, which can be "PRT:" to print directly to the printer.
  248. (Note: background printing is not implemented, meaning that Spread will
  249. stall until the spreadsheet had been printed entirely.)
  250.  
  251.     "Project/About Spread": Try it and see.
  252.  
  253.     "Project/Quit": Leaves Spread. If a spreadsheet is loaded it
  254. will be lost; make sure you save it first if you want to keep it. The
  255. close window button in the upper left corner performs the same function.
  256.  
  257.     "Edit" Menu
  258.  
  259.     "Edit/Cut": The current cell is saved in the paste buffer, and
  260. becomes empty. (The 'current' cell is the cell the cursor is positioned
  261. on, which is displayed in reverse.)
  262.  
  263.     "Edit/Copy": The current cell is saved in the paste buffer. The
  264. current cell is not altered.
  265.  
  266.     "Edit/Paste": If the current cell is empty, then the contents of
  267. the paste buffer is placed in the current cell.
  268.  
  269.     "Edit/Erase": The current cell is made empty. It is not saved in
  270. the paste buffer, and the paste buffer is not disturbed.
  271.  
  272.     "Edit/Insert Row": The contents of all cells below and to the
  273. right of the current cell, including the current cell, are shifted one
  274. row down. The current cell and all the cells in the current row to the
  275. right are made empty.
  276.  
  277.     "Edit/Insert Col": The contents of all cells below and to the
  278. right of the current cell, including the current cell, are shifted one
  279. row to the left. The current cell and all cells below the current cell
  280. are made empty.
  281.  
  282.     "Edit/Delete Row": The contents of all cells below and to the
  283. right of the current cell are shifted one row up. The contents of the
  284. current cell, and of all cells in the current row to the right, are
  285. lost.
  286.  
  287.     "Edit/Delete Col": The contents of all cells below and to the
  288. right of the current cell are shifted one row to the left. The contents
  289. of the current cell, and of all cells in the current column below, are
  290. lost.
  291.  
  292.     Warning: If any cells use RmCn notation with actual cell numbers
  293. in a formula, and the target cell is moved by any insert or delete
  294. operation, then it's likely the formula is now incorrect. The cell name
  295. feature should be used when making references to cells in formulas, as
  296. name references are resolved regardless of cell locations.
  297.  
  298.     "Cells" Menu
  299.  
  300.     "Cells/Edit Cell Text": If the current cell is empty, it is made
  301. a text cell. The Text gadget at the bottom of the window is activated,
  302. as if you had clicked on it. Pressing the 'E' key has the same effect as
  303. "Cells/Edit Cell Text", or if the text gadget is not ghosted you may
  304. simply click on it to edit.
  305.  
  306.     "Cells/Edit Cell Formula": If the current cell is empty, it is
  307. made a formula cell. The Text gadget at the bottom of the window is
  308. activated, as if you had clicked on it. Pressing the 'F' key has the
  309. same effect as "Cells/Edit Cell Formula", or if the text gadget is not
  310. ghosted you may simply click on it to edit.
  311.  
  312.     "Cells/Edit Cell Name": The Name gadget at the bottom of the
  313. window is activated, as if you had clicked on it. Pressing the 'N' key
  314. has the same effect as "Cells/Edit Cell Name", or if the name gadget is
  315. not ghosted you may simply click on it to edit.
  316.  
  317.     "Calculate" Menu
  318.  
  319.     "Calculate/Evaluate": The formulas in the current spreadsheet
  320. are solved, and the results of the calculations are displayed in the
  321. formula cells. This is the way to cause calculation if Auto Calc is
  322. disabled, or if a calculation makes a forward referece to a cell (see
  323. 'order of calculation' above).
  324.  
  325.     "Calculate/Auto Calc": When this entry is checked, the 'auto
  326. calc' feature is enabled. Selecting this entry toggles it's state
  327. between enabled (checked) and disabled (not checked).
  328.  
  329.     "Format" Menu
  330.  
  331.     "Format/Set Column Width": This entry brings up a requester
  332. which allows you to enter the width of the current column, by the number
  333. of characters it should hold.
  334.  
  335.     "Format/Set Decimal Places": This entry brings up a requester
  336. which allows you to enter the number of digits to the right of the
  337. decimal point should be printed for formula cells in the current column.
  338.  
  339.     "Format/Set Normal Font": Selecting this entry causes Spread to
  340. use Topaz/8 for cell display.
  341.  
  342.     "Format/Set Narrow Font": Selecting this entry causes Spread to
  343. use the teeny/8 font for cell display. The teeny/8 font distributed with
  344. Spread uses 5 pixel wide character spacing, which can display up to 128
  345. characters on the 640-pixel Workbench screen, although the border
  346. imagery around the Spread window allows only about 120 characters. If
  347. the 'teeny/8' font is not in your current fonts: directory, this menu
  348. selection will be ghosted.
  349.  
  350.     If you generate your own font and call it teeny/8, or copy
  351. another existing font to teeny/8, then Spread will use it with it's
  352. metrics. It should be an 8 pixel high font, but could be a wider or
  353. narrower font, fixed spacing or proportional. Spread will adjust
  354. accordingly.
  355.  
  356.  
  357. *****************************************************************************
  358.  
  360.  
  361.                                MemoPad 
  363.  
  364.   MemoPad and CheckMemo are products which may be freely distributed 
  365.   on the condition that they are not altered in any way, either by 
  366.   omission or addition to the contents of the ARC file.
  367.  
  368.  
  369.                     Commercial Release Version
  370.                     ==========================
  371.  
  372.   In order to better support users of MemoPad we will be producing a
  373.   commercial version which may be known under a different name -- yet
  374.   to be determined.  Our working name has been MemoPad V2.0.  Due to
  375.   a significant number of changes we may be forced to change the name
  376.   to better describe this new product.  Following is a partial list of
  377.   planned features :
  378.  
  379.     1) An address book facility with an automatic telephone dialer 
  380.        will be added.
  381.  
  382.     2) A daily appointment utility will be supported which allows
  383.        appointments to be booked at selectable intervals.
  384.    
  385.     3) The original MemoPad functions will also be available along
  386.        with a facility to allow batch processing to be invoked via
  387.        a dated and timed memo item.
  388.  
  389.     4) A speech facility will be added to allow memo items or 
  390.        appointments to be announced.
  391.  
  392.     5) More options will be added to give more flexibility in
  393.        selecting screen colours, methods of repeating memos and
  394.        appointments, and in reporting matured items.
  395.  
  396.     6) Text import/export into/from the address book, appointments,
  397.        or memo items will be supported.
  398.  
  399.   Note that although all these additions are planned to appear in the
  400.   commercial release we cannot guarantee that they will operate exactly
  401.   as described above.  Whenever possible we will attempt to improve on
  402.   our offerings and thus the list above may become obsolete.  Please
  403.   contact us at the above address or telephone number to get up to date
  404.   information.   
  405.   
  406.  
  407.                    Installing MemoPad & CheckMemo
  408.                    ==============================
  409.  
  410.   There should be a total of 7 files for this program set.  As soon as
  411.   you invoked `ClickMe', all the names (if they were de-arced) were
  412.   auto-magically expanded out, so you won't have to go through the
  413.   usual hassle of EXECUTING the Execute.Me file that is usual in these
  414.   cases. 
  415.  
  416.   Install MemoPad as follows from the Command Line Interpreter (CLI) :
  417.   (Make certain there is enough disk space to hold the copied files.
  418.    The MemoPad disk icon should be named `MemoPad:'.  Substitute the
  419.    name/directory of the disk which is to hold the MemoPad utility
  420.    in place of the dummy "Working Disk" name).
  421.  
  422.   FROM CLI :
  423.       Copy MemoPad:CheckMemo to C:
  424.       Copy MemoPad:MemoPad#? to "Working Disk"
  425.       Copy MemoPad:CheckMemo#? to "Working Disk"
  426.       Copy MemoPad:ClickMe#? to "Working Disk"
  427.       Copy S:Startup-Sequence to S:Startup-Old
  428.  
  429.   Finally, in order to automatically invoke `CheckMemo' when the
  430.   AMIGA is powered on, invoke your favourite editor to modify the
  431.   following file : S:Startup-Sequence.  Place the line `CheckMemo',
  432.   without the quotes, near the end of this file, just before the
  433.   line containing `EndCLI > Nil:'.
  434.  
  435.   Note: you can also manually check the memo items at any time simply
  436.   by typing `CheckMemo' from CLI or by clicking on the CheckMemo icon.
  437.   If nothing happens except a disk access when you invoke CheckMemo,
  438.   don't worry -- it just means that no memo items were found for
  439.   today's date.
  440.  
  441.   The MemoPad utility, which creates the memo items read by CheckMemo,
  442.   was placed on your working disk as part of the installation.  It is
  443.   also possible to just drag the MemoPad icon over to your working
  444.   disk.
  445.  
  446.                           MemoPad Operation
  447.                           =================
  448.  
  449.   MemoPad is a WorkBench utility which runs in a separate window on
  450.   the WorkBench screen. It is capable of allowing you to generate memo
  451.   items which are simply dated reminders of appointments, birthdays,
  452.   holidays, or any to do list.  Each memo item can be any length, 
  453.   limited only by the amount of memory or disk space where the memos
  454.   are stored.
  455.  
  456.   When MemoPad is first invoked, it searches the S: startup directory 
  457.   for a file called MEMOPAD.DAT.  This file contains all the memo items
  458.   which have been entered by yourself.  Naturally, the first time it is
  459.   invoked, MemoPad won't find this file and will attempt to create one.
  460.   At this time, you may get a message indicating that the WorkBench
  461.   disk is required or that you should unprotect the write tab.  
  462.  
  463.   During start-up, one other file is accessed : MEMOPAD.CUS.  This file
  464.   contains user customization information which allows you to customize
  465.   the MemoPad operation to your individual preferences via the 
  466.   CUSTOMIZE menu selection in MemoPad.  If this file is not found, 
  467.   MemoPad makes some assumptions and gives you a 24-hour clock, a 
  468.   day-month-year date, and a plain MemoPad title.  Naturally, you can 
  469.   customize all these parameters and the next time MemoPad is invoked,
  470.   all your selections will be used.  By the way, the same selections 
  471.   will also be used by CheckMemo.
  472.  
  473.  
  474.                   Changing the Data File Directory
  475.                   ================================
  476.  
  477.   We felt that everyone would have WorkBench in their drive during 
  478.   startup, so this is where MemoPad normally assumes it will find your
  479.   memo items.  If you don't like these files on your WorkBench disk, 
  480.   then it is possible to change the directory where MemoPad will look.
  481.   device to some other disk.  MemoPad and CheckMemo both accept an
  482.   optional parameter on the command line which is the directory which
  483.   they will use in place of the default S: directory.  To change from
  484.   the default simply edit the S:Startup-Sequence file again, replacing
  485.   the `CheckMemo' line with `CheckMemo DIRECTORY', where DIRECTORY is
  486.   replaced by a directory or device string.  As an example, if we wish
  487.   the MemoPad files to be placed on our working disk, WORK:, and in 
  488.   the MemoFiles directory, we would enter `CheckMemo WORK:MemoFiles'
  489.   into the S:Startup-Sequence file.  Whenever invoking MemoPad, you
  490.   will also have to remember to specify the new directory in the
  491.   CLI invocation line, so for our example, we would type :
  492.   `MemoPad WORK:MemoFiles'.
  493.  
  494.   If invoking MemoPad and/or CheckMemo from the WorkBench, simply edit
  495.   the INFO file from the corresponding WorkBench menu, after having
  496.   selected either the MemoPad or the CheckMemo icon, and place the 
  497.   desired new directory specification as the first item in the 
  498.   `Tool Types' string gadget.  Thus our example from above would
  499.   require that the default tool type entry of `MEMODIR=S:' be 
  500.   changed to read the following instead : `MEMODIR=WORK:MemoFiles'.
  501.   Don't include the quotes.  Be sure to do this for both the MemoPad
  502.   and CheckMemo icons.
  503.  
  504.  
  505.                         Operating Instructions
  506.                         ======================
  507.  
  508.   Creating a Memo Item
  509.   --------------------
  510.   Click on the ENTER button to create a memo item.  The total number
  511.   of memos should increase by one and the newly created item will be
  512.   automatically assigned today's date.  The comment field will be
  513.   blank.  To enter some text, just point to the line where the text
  514.   is to be placed and click with the left mouse button.  Then type
  515.   the memo text.  A RETURN will automatically take you to the next
  516.   line of the comments.  
  517.  
  518.   Comments longer than five lines can be created by clicking on the
  519.   down arrow under the comment scroll bar.  The scroll bar will reduce
  520.   to half its original size.  The text which is displayed represents
  521.   those five memo lines located in the scroll bar range.  Thus, if
  522.   we created a new page of comments, we now have a total of ten 
  523.   comment lines available for this memo item.  The scroll bar's
  524.   position illustrates where we are within this ten line range.  By
  525.   clicking on the down arrow repeatedly, additional comment pages in
  526.   multiples of five lines are created.  New pages are created as soon
  527.   as the scroll bar reaches the bottom of its container and the down
  528.   arrow is clicked.  The only limitation to the comment size is the 
  529.   amount of memory available.  A help message will let you know when
  530.   you run out of memory.
  531.  
  532.   The up and down arrows work in cooperation with the scroll bar to
  533.   advance the comment window up or down by a single line of text.
  534.   Click on the up arrow to move up a line and click on the down arrow
  535.   to move down a line.  Pages of five lines are traversed by clicking
  536.   just within the scrolling container either under the scroll bar to
  537.   move down five lines or above the scroll bar to move up by five
  538.   lines.
  539.  
  540.   A trailing blank page of comment lines is automatically deleted once
  541.   it is no longer visible.  The scroll bar also changes its size 
  542.   and position to reflect the reduced number of comment lines. 
  543.   Blank page deletion occurs either when the scroll bar is dragged to
  544.   the top of the scroll container or repeated clicks on the up arrow
  545.   cause the blank page to scroll off the comment area.
  546.  
  547.  
  548.   Viewing Memo Items
  549.   ------------------
  550.   The date window, which normally is used to set a memo item's date,
  551.   can also be used to display all the memo items for a given month.
  552.   Just click on the VIEW button and all memo items for the current
  553.   month will be highlighted in the date window.  Any dates with more
  554.   than one item will be outlined.  To see the contents of one of 
  555.   these memo items, just click on the highlighted date.  The related
  556.   memo item will be displayed in the main window. (You may have to
  557.   move or QUIT the date window in order to see the full memo text.)  
  558.   Multiple memos on a single date are displayed in a similar manner.
  559.   Once the first memo item has been shown, the MORE button in the
  560.   date window will light up to indicate that additional items are
  561.   available.  Click on the MORE button to see these memos one at a
  562.   time.
  563.  
  564.  
  565.   Printing Memo Items
  566.   -------------------
  567.   The Print menu options give printer output from all the memo items or
  568.   just the memo currently being displayed.  By displaying only selected
  569.   items, then invoking the single memo print option from the menu, it
  570.   is possible to selectively print only those memos due for a single
  571.   day.  The amount of space on the left of the printed memo items can
  572.   be altered by adjusting the printer left margin from within
  573.   Preferences.  Make certain that the right margin is adjusted so that
  574.   sufficient space is available on the print line to contain a full 
  575.   line of comment text.
  576.  
  577.  
  578.   Repeating Memo Items
  579.   --------------------
  580.   MemoPad lets you specify repeated memo items which occur fairly 
  581.   regularly on a daily, weekly, monthly, or annual basis for a fixed
  582.   length of time.  To generate such a memo item, first you'll have to
  583.   enable repeats by selecting one of the repeat choices in the REPEAT
  584.   MEMO menu list. By default, repeats will be disabled as is shown by
  585.   the checkmark in front of the "No Repeat" menu item.  Choose one of
  586.   the repeat options and use the NEXT or PREV buttons to get to the
  587.   memo you wish to have repeated.  Click on the DATE button, and use
  588.   the Date Window controls to get to the starting date to be repeated.
  589.   Click on the desired date.  All repeated dates will now also be
  590.   selected.  Use the Date Window controls to check them if you don't
  591.   believe it could be that easy.  Click on the OK button to close the
  592.   Date Window and accept the chosen date; otherwise, just click on
  593.   the QUIT button to keep whatever date was originally on your memo
  594.   item.
  595.  
  596.   
  597.   Finding a Dated Item
  598.   --------------------
  599.   The FIND button and the related menu item will let you find one memo
  600.   out of the list of memo items which you have defined.  Click on this
  601.   button, use the Date Window controls to maneuver to the desired date,
  602.   and click on the date to be found.  Click on the OK button and the
  603.   first memo item with this date will be located and displayed.  This
  604.   date search may be cancelled by clicking on the QUIT button.  If the
  605.   date is not found, a message indicating this will be displayed in the
  606.   Help Window.  A trick, which may be used to find any memo item in
  607.   a given month might be to select the daily repeat for a month before
  608.   clicking on the Date button.  Any date which is selected will now
  609.   cause a search throughout the entire repeat range for any matching
  610.   memo item dates.
  611.  
  612.  
  613.   Help Window
  614.   -----------
  615.   The Help Window is a context sensitive help feature which displays
  616.   help messages as various buttons and/or menu selections are made.
  617.   It is located in the top rightmost portion of the MemoPad window.
  618.  
  619.  
  620.   Automatic Memo Item Backup
  621.   --------------------------
  622.   There is never any need to worry whether or not all your memo items
  623.   have been saved to disk!  MemoPad will automatically update the disk
  624.   file, as soon as it notices that some memo item has been changed.
  625.   Even if some other program should cause the AMIGA to crash in a 
  626.   shower of fireworks, you'll be secure in the knowledge that your
  627.   memo items are safe.
  628.  
  629.  
  630.                         About the Modula-2 Source
  631.                         =========================
  632.  
  633.   We, as a company, provide the source code for MemoPad and CheckMemo
  634.   primarily to give interested individuals the tools for programming
  635.   the Amiga using the Intuition-based interface in Modula-2.  Included
  636.   in the source are many examples of gadget-based control, menu 
  637.   initialization and use, window creation and manipulation, and 
  638.   requester window use. Although bits and pieces of what we do are 
  639.   available in other programs, we feel that having an example which
  640.   unites all the working principles required to produce a full program
  641.   is beneficial to novice AMIGA programmers.  Our primary aim, of 
  642.   course, was to produce a program from which others could see how to
  643.   work within an Intuition-based environment using Modula-2; and in 
  644.   this respect, we feel that we have succeeded.
  645.   
  646.   
  647.                             Acknowledgements
  648.                             ================
  649.  
  650.   As always, there are a bunch of people behind the scenes who must be
  651.   thanked for their contributions, either direct or indirect, to a 
  652.   program such as this.  Firstly, thanks to TDI for their Modula-2
  653.   compiler, which may not be fastest or the best, but it certainly was
  654.   the first.  Secondly, thanks to all the people who have contributed
  655.   public-domain programs to demonstrate Modula-2 concepts and give 
  656.   others source code examples upon which to build.  In particular,
  657.   thanks to Richie Bielak for his FastTextIO routines, used in this
  658.   previewer and thanks also go to Jerry Mack for his TextTools module
  659.   used in MemoPad. We also appreciate the artistic talents of Anna Lise
  660.   Scheel, Colour Consultant, for her work on MemoPad.  Thanks also to
  661.   all the Beta test sites (you know who you are) for their assistance
  662.   and helpful comments.  Thanks also to the people who brought us
  663.   PowerWindows which was used as a starting point for the design of
  664.   windows, gadgets, menus, and requesters used in both MemoPad and
  665.   CheckMemo.  Although, the Modula-2 extensions to this program are
  666.   VERY buggy and have been given inadequate thought, the tool has been
  667.   useful. Finally, thanks to the makers of the Amiga -- without whom
  668.   none of this would have been possible.
  669.  
  670.  
  671.                                Bug Fixes
  672.                                =========
  673.  
  674.   Much as we hate to admit it, a few bugs crept into the V1.0 release
  675.   of MemoPad and CheckMemo.  Thanks to the people who pointed out the
  676.   bugs (people tend to do that).  All known bugs as listed below have
  677.   been exterminated :
  678.  
  679.      Bug 1.0-1  The programs stomped over memory location 00000000
  680.                 while starting up and initializing the Date window.
  681.                 Although this bug didn't usually cause the programs
  682.                 to crash, sometimes, if another program depended on
  683.                 something in memory location 00000000, a crash could
  684.                 occur.  As a matter of fact, if both MemoPad and
  685.                 CheckMemo were running together (yes, they can do
  686.                 that too), closing down one would cause the other
  687.                 one to crash the Amiga.  In our defense, the bug
  688.                 was traced to a pointer to a pointer which the
  689.                 current V3.0a TDI Modula-2 compiler doesn't seem to
  690.                 handle very well.  PowerWindows forced us to use
  691.                 the awkward pointer to a pointer syntax (they must
  692.                 be `C' programmers!), hence our memory stomping.
  693.  
  694.      Bug 1.0-2  To our shock, we discovered that the DOS date was 
  695.                 in error by one day (at least during this leap year).
  696.                 It worked fine last year. ;-)
  697.                 A new algorithm is now being used.
  698.  
  699.   To date no bugs have been reported for MemoPad V1.1.  Please let
  700.   us know if you find any in this V1.2 release.
  701.    
  702.                 
  703.                         About Computer Inspirations
  704.                         ===========================
  705.  
  706.   Although COMPUTER INSPIRATIONS is fairly new to the AMIGA and other 
  707.   personal computers, we have gained considerable experience in 
  708.   software and hardware development from work in the aerospace industry
  709.   and from a university environment.  We are committed to bringing 
  710.   quality products to AMIGA owners at affordable prices.  We will make
  711.   certain that all our products reflect this attention to detail and
  712.   we will respond promptly to any customer problems or concerns.
  713.  
  714.   Michael Griebling,
  715.   President, COMPUTER INSPIRATIONS
  716.  
  717.  
  718.  
  719.  
  720. *****************************************************************************
  721.  
  723.  
  724.  
  725.  
  726.                         USER'S GUIDE TO DWIP
  727.                         ====================
  729.  
  730. ACKNOWLEDGEMENT: DWIP is heavily based on the jiff and plop programs by
  731. Jim Kent.  Many thanks to Jim for writing a well-documented IFF file
  732. reader/displayer.  This program would have taken me months to write
  733. without his code, instead of the two days that it actually took.
  734.  
  735. INTRODUCTION:
  736.     DWIP stands for "Daisy Wheel IFF Printer", and it is intended as a
  737. general-purpose IFF file printing utility for Amiga users who either
  738. (1) want to do graphics on their daisy wheel printer; or (2) just want
  739. to quickly make very large dumps of their IFF files.
  740.     While it is true that most screen dump utilities will allow the user
  741. to blow up his image as large as he likes, it is generally impractical
  742. to blow up images to a very large size because of the time involved
  743. (not to mention expense in printer ribbons and wear&tear on your printer).
  744. I wrote DWIP because I wanted to create large banners quickly of files I
  745. had created on my Amiga.  (Note that I use the word "quickly" in a relative
  746. sense.  I think DWIP is about as quick as you can possibly get in making
  747. screen dumps with standard printers, but it still takes awhile to print
  748. a screen.)
  749.     First, the good news: DWIP works with just about ANY printer.  It
  750. just uses standard text characters, overstriking them in varying amounts
  751. to make different shades of grey.  It does overstriking by first sending
  752. one entire line of characters, then a carriage return code (CR), followed
  753. by another line of characters and another until the desired darkness is
  754. achieved (up to 5 passes for the darkest shade).  It only sends a line 
  755. feed code (LF) when it is done with all passes over a given line.  This 
  756. is in keeping with the way the Amiga operates, sending out only a LF at 
  757. the end of a line, which returns the carriage to its home position and 
  758. also moves the roller forward one line.
  759.     In normal operation, the Amiga doesn't use the CR at all, but most
  760. printers use the CR only to return the carriage without moving the
  761. roller.  However, some will move the roller as well when they get a CR,
  762. and in that case DWIP will not work properly with the default settings.
  763. Here's what you should do to test DWIP:  There is a "test" mode, which you
  764. invoke by typing:
  765.  
  766. DWIP -z
  767.  
  768. This will produce a file starting with the letters DW and having four
  769. more characters after that, in your RAM: directory.  You can print that
  770. file on your printer, as in:
  771.  
  772. copy RAM:filename to prt:
  773.  
  774. What you should see is five lines, each one having 36 characters in it.
  775. (Actually, there are many more characters than that, but the ones toward
  776. the left should be overstruck to produce dark rectangles over the letter
  777. positions.)  The five lines should all be identical and single-spaced, 
  778. and they should look nearly black on the left and nearly white on the 
  779. right.  This is the DWIP grey-scale.
  780.     If your test pattern doesn't look like this, chances are you're
  781. looking at about 25 lines of output instead of 5.  In that case, your
  782. printer is moving the roller with every carriage return code.  I would
  783. recommend checking your printer manual at this point, and see if there
  784. is a dip switch that controls the treatment of carriage returns.  Disabling
  785. automatic linefeeds with every carriage return should make DWIP work
  786. properly, without affecting the normal operation of your printer with the
  787. Amiga.  If you can't find such a dip switch on your printer, or if moving
  788. it affects your other printing with the Amiga, then there is one other
  789. possibility.  There is a "universal printer" option on DWIP (-u) which
  790. you can try.  It works by sending a bunch of backspaces at the end of
  791. each line, instead of a CR, so there's a chance this might work with your
  792. printer.  (Actually, this option isn't as universal as I had intended,
  793. since some printers don't seem to backspace a full character width and
  794. the result is a real mess.)  To try this option, use:
  795.  
  796. DWIP -z -u
  797.  
  798. and then use the copy command to print out the resulting file.  (It will
  799. have a different name from the first one.)  And if this doesn't give the 
  800. 5-line test pattern I described above, you're out of luck.  DWIP doesn't 
  801. work with your printer.
  802.  
  803.     Now on to continue with the good news:
  804.  
  805.     A dot matrix printer will work just as well as a daisy wheel 
  806. printer.  I named DWIP for daisy wheels because this is the only graphics 
  807. printing utility I know of for the Amiga that also works on daisy wheel 
  808. printers.
  809.     Also in the realm of good news, I'll tell you that DWIP has many
  810. options, allowing you to print any part of the screen on printers of
  811. any carriage width, either normal or sideways.  It can even be used as
  812. a quick-and-dirty slide-show program (although it doesn't do fancy things
  813. like scrolls, fades or dissolves).
  814.     Finally, DWIP can blow up a picture as large as you like, including
  815. generating more than one character on your printer per dot on the screen.
  816. That means you can make some very large banners from your IFF files,
  817. although of course you'll have to do some pasting as soon as you go
  818. beyond the width of your printer.  (However, DWIP has a sideways printing
  819. option so you can print very long images in a single pass.)
  820.     Now for the bad news: First of all, DWIP doesn't do color.  It
  821. approximates the colors of the screen as shades of grey (you have control
  822. over that, too).
  823.     Second, DWIP doesn't currently support all the IFF file formats.  It
  824. is limited to low-resolution, non-HAM screens.  (No interlace, overscan,
  825. PAL, high-resolution, or HAM files will work.)  Third, it doesn't run from
  826. the workbench; you have to run it from the CLI.
  827.  
  828. USING DWIP
  829. ==========
  830.     The format for starting DWIP from the CLI is as follows:
  831.  
  832. DWIP [options] files
  833.  
  834. There are many options in DWIP, and any or all may be used in combination.
  835. All options consist of a minus sign (-) and a one-letter code.  In addition,
  836. many codes are followed by a number (annotated as "val" below) or a
  837. string of characters (annotated as "string" below).  Here is a summary of 
  838. all the options:
  839.  
  840.     -lval      set leftmost location on screen (default 0)
  841.     -tval      set top location on screen (default 0)
  842.     -wval      set width of screen area to print (default 320)
  843.     -hval      set height of screen area to print (default 200)
  844.     -pval      set printer pitch (default 10)
  845.     -cval      set # columns to use across printer (default 135)
  846.     -nval      set # lines per inch on printer (default 6)
  847.     -istring   set initialization string (default is none)
  848.     -estring   set end-of-line string (default is newline)
  849.     -u         "universal" printer option (use backspaces instead of CR)
  850.     -ofile     send output to named file (default is PRT:)
  851.     -s         print sideways
  852.     -m         "modified" picture (inverse intensity)
  853.     -rval      set red relative intensity (default 1.0)
  854.     -gval      set green relative intensity (default 0.7)
  855.     -bval      set blue relative intensity (default 1.0)
  856.     -vtime     view file for time seconds, instead of printing
  857.     -z         print a test pattern (after any named files)
  858.  
  859. The default for DWIP is to make a copy of the entire screen on the printer
  860. using 135 columns (standard wide-carriage printer in 10-pitch).  To zoom 
  861. in on a smaller portion of the screen, you have to specify the coordinates
  862. of the left, top corner of the area you want, as well as the width and
  863. height of the area.  For instance, if you wanted to print an area beginning
  864. 110 dots (pixels) in from the left edge of the screen, 200 dots wide,
  865. and beginning 50 dots from the top edge of the screen, 100 dots high,
  866. of an IFF file named "myfile", you would start DWIP with the command:
  867.  
  868. DWIP -l110 -w200 -t50 -h100 myfile
  869.  
  870. DWIP IS case-sensitive, so be sure to use lower-case letters on the options.
  871. File names are the same as standard AmigaDOS, so case doesn't matter there.
  872.     To complicate matters, let's say you only have an 80-column printer.
  873. Then you would have to use the -c parameter to set the number of columns,
  874. as in:
  875.  
  876. DWIP -l110 -w200 -t50 -h100 -c80 myfile
  877.  
  878.     Or suppose your printer prints in 12 pitch, instead of 10 (which DWIP
  879. assumes).  You can specify the pitch with the -p parameter, as in: -p12
  880.     Or suppose your printer had a compressed printing mode that let you
  881. put 120 characters across a standard 8" printing area.  Then you'd need
  882. the -c parameter (-c120), but you'd also need to change the pitch. Pitch 
  883. is just the number of characters per inch, so you have 120 / 8 = 15.
  884.     You can also change the vertical pitch (the number of lines per inch)
  885. with the -n parameter.  The default is 6 (as in 66 lines / 11 inches),
  886. the standard for nearly all printers, but you can easily change this.
  887.     You will notice that although DWIP gives you direct control over the
  888. width of the picture you will produce (via the -c parameter), you do not
  889. have control over the length of the picture produced.  DWIP automatically
  890. selects a picture length to keep the aspect ratio of the screen as nearly
  891. as possible.
  892.  
  893.     The output file name DWIP chooses is intended to be a "unique" name.
  894. So it makes up a name that doesn't already exist in the RAM: directory
  895. and uses that.  If you use DWIP several times, you have to be careful
  896. to delete these files or they'll pile up because DWIP never overwrites
  897. these files.  The alternative is for you to explicitly tell DWIP the file
  898. name you'd like your output to go to.  Use the -o option, and you can
  899. send the file anywhere you like.  For instance, you can send the output
  900. to a file call "myoutput" on your hard drive with a command like:
  901.  
  902. DWIP -odh0:myoutput [options] myfile
  903.  
  904. You can even specify "prt:" as the output file, and then Dwip will
  905. automatically print it for you and you can skip the intermediate-file
  906. step.  I don't really recommend this, however, since you can't stop
  907. Dwip once it starts printing.  This is true if you try to stop it, or 
  908. if your printer goes offline and the familiar "Printer Trouble" requester 
  909. appears.
  910.     Since Dwip itself is pretty fast, and the only slow step is the
  911. actual printing, you may want to do that step in the background, as in:
  912.  
  913. run c:copy RAM:file to prt:
  914.  
  915. By using the 'run' command, you can then go on and do other things
  916. while the file is printed.
  917.  
  918.     DWIP prints color pictures by estimating the brightness of each
  919. different color.  The basic idea is to add the red, green and blue
  920. components of the color.  This would yield a number in the range from
  921. 0 (black) to 45 (white) since each of the RGB components has a range
  922. from 0 to 15.  However, I have made the observation that the green 
  923. color on the Amiga is somewhat lighter than the red or the blue.  You 
  924. can see this very easily in Preferences by creating a screen with full 
  925. green color and no red or blue, and comparing it to the corresponding 
  926. red and blue full colors.  Therefore, I call the red and blue "full 
  927. darkness" colors, but green is only about 70% as dark.  Note that I 
  928. speak of darkness, not lightness.  That's because DWIP starts with a 
  929. white sheet of paper and adds darkness to the dots to create a picture.
  930.     If you disagree with my choices, you can easily change them yourself.
  931. The -r, -g and -b parameters allow you to enter a decimal number (between
  932. 0 and 1) corresponding to the percentage of darkness for each component.
  933. The default is 100% (1.0) for red and blue, and 70% (0.7) for green.
  934. To give equal weighting to all three colors, just use -g1.  You can
  935. effectively darken the entire picture by setting numbers slightly greater
  936. than 1 for the 3 parameters, or lighten it by using numbers less than 1
  937. (but never less than 0).
  938.     By default, DWIP sends no initialization string to the printer and
  939. only a linefeed character at the end of each line.  You can change each
  940. of these, to suit the needs of your printer.  For instance, you may want
  941. your printer to do a form feed before each picture, or you may want it
  942. to send an escape code to change the printer pitch.  The format for
  943. specifying an initialization string is -istring where "string" is any
  944. string of characters.  You can embed non-printing ASCII codes by
  945. specifying them in the form \nnn where nnn is a 3-digit decimal number
  946. for the ASCII code.  (NOTE, C programmers, that even with a leading zero
  947. this number is decimal, NOT octal!)  For instance, you can tell DWIP to 
  948. send a form feed (ASCII code 12) before every picture by using:
  949.  
  950. DWIP -i\012 myfile
  951.  
  952. Note that all three digits (012) must be specified.  Or if you need to 
  953. send an escape, left-bracket ([), and 't' you would use:
  954.  
  955. DWIP -i\027[t myfile
  956.  
  957.     You can set the end-of-line code sent by DWIP in the same manner.
  958. By default, DWIP sends only a linefeed code (ASCII 10), but with the -e
  959. option you can specify any string you like.  Note that here I am talking
  960. about what DWIP does AFTER all overstriking is complete; only the -u
  961. option discussed above affects what is done DURING overstriking.
  962.     You can print sideways by using the -s flag, or you can "invert" the
  963. image with the -m (modify) flag.  By "invert", I mean printing the
  964. negative of the image, exchanging dark for light as in a photo negative.
  965. (This option really should have been flagged as -i or -n, but both of
  966. those letters were already being used for other options, so I was stuck
  967. with -m.  Such are the perils of the English language. :<] )
  968.     Finally, if you use the -v option you can make DWIP act like a simple
  969. slideshow utility.  The number after the v is the number of seconds to
  970. pause before bringing up the next picture.  For instance:
  971.  
  972. DWIP -v10 file1 file2 file3
  973.  
  974. would display each of the 3 files in succession, pausing 10 seconds
  975. between each one.  This option stops any printing from being done at
  976. all; it is strictly for viewing files.
  977.     One final note: all parameters to DWIP are order-dependent; they
  978. are evaluated as they are encountered, and can be placed in whatever
  979. order is logical for your situation.  You can set and reset parameters
  980. in a single command line.  For instance, you could do something like:
  981.  
  982. DWIP -l20 -w200 -c80 -ofilout1 myfile1 -l120 -t100 -ofilout2 myfile2
  983.  
  984. This would use two different output files, with the picture for myfile1
  985. being sent to filout1 and the picture for myfile2 sent to filout2.  The
  986. -s and -m parameters are toggles, incidentally.  Using them once in a
  987. command turns the option on; using them again turns them off, and so on.
  988.  
  989. Happy printing! (:<)
  990.  
  991. *****************************************************************************
  992.  
  994.  
  995.  
  996.  
  997.                            Keyclick version 1.1
  998.  
  1000.  
  1001.      One thing I always missed about the Amiga was an audio click when the
  1002.  
  1003. keys were pressed.  While the Amiga keyboard has the best feel of any I've
  1004.  
  1005. typed on, it doesn't have a form of audio feedback, which aids in
  1006.  
  1007. touch-typing.  Thanks to the multitasking operating system however, the
  1008.  
  1009. addition of such a feature is relatively painless, both from a user's and a
  1010.  
  1011. programmer's standpoint.
  1012.  
  1013.      Upon running the program, a window will be presented which contains
  1014.  
  1015. two gadgets.  The slider is used for adjusting the volume of the click.  The
  1016.  
  1017. toggle switch can be "pressed" to turn the sound on or off.  After the
  1018.  
  1019. program is up and running, an audio click will be produced at each press of
  1020.  
  1021. a key on the keyboard or a mouse button.  You cannot run more than one key
  1022.  
  1023. clicker at a time; the second clicker that you run will indicate that a
  1024.  
  1025. key-clicker is already active in the system.  Simply close the window to
  1026.  
  1027. end the program.  That's about all you have to know as a user.
  1028.  
  1029.      For you programmers out there...  This program demonstrates custom
  1030.  
  1031. input handlers and effectively sharing the complicated audio device; two
  1032.  
  1033. concepts that can be put to great use.
  1034.  
  1035.      The center of activity revolves around a custom input handler, which
  1036.  
  1037. simply signals the waiting task when a key or mouse button event arrives in
  1038.  
  1039. the input stream.  Once the task is awakened, it sends a command to the
  1040.  
  1041. audio device to initiate the click and goes back to sleep. Therefore, this
  1042.  
  1043. program only uses a significant amount of processor time when a key or
  1044.  
  1045. mouse button is actually pressed.
  1046.  
  1047.      I had the program set its own priority to fourty (this can be changed
  1048.  
  1049. by assigning a different value to TASK_PRIORITY, defined at the beginning
  1050.  
  1051. of the program) for better response.  At lower task priority values, the
  1052.  
  1053. program tended to be sluggish on occasion (especially in a busy system).
  1054.  
  1055. The input handler priority (defined by HANDLER_PRIORITY) is set at
  1056.  
  1057. fifty-one.  This causes events from the input stream to be intercepted
  1058.  
  1059. before Intuition gets ahold of them.  This is desirable because Intuition
  1060.  
  1061. "swallows" some of the events.  That is, it removes some of them from the
  1062.  
  1063. input stream, preventing the custom input handler from notifying the
  1064.  
  1065. clicker task.
  1066.  
  1067.      At each stroke of a key, an audio channel is allocated, a sound
  1068.  
  1069. request is issued to the audio device, and the channel previously allocated
  1070.  
  1071. is freed.  All of this takes place within the click() routine.  After a
  1072.  
  1073. channel is allocated (via a call to get_audio_channel()), the io_Unit
  1074.  
  1075. parameter is checked to see if an allocation actually succeeded.  A zero in
  1076.  
  1077. this parameter indicates that no channel could be allocated.  If this is
  1078.  
  1079. the case, the click() routine returns immediately without attempting to ask
  1080.  
  1081. the audio device to make a click sound.  Any other value in io_Unit denotes
  1082.  
  1083. which channel has been allocated for use.  The IOAudio structure is
  1084.  
  1085. prepared for a CMD_WRITE to issue a sound request to the audio device, and
  1086.  
  1087. is executed with a call to BeginIO().  A WaitIO() call is immediately
  1088.  
  1089. issued after the BeginIO() so the program waits until completion of the
  1090.  
  1091. write request.  This is needed to delay freeing the channel until the click
  1092.  
  1093. sound is completed playing (after WaitIO() returns, a call to
  1094.  
  1095. free_audio_channel() frees the previously allocated audio channel).
  1096.  
  1097.      An alternate method of audio manipulation would be to allocate an
  1098.  
  1099. audio channel at the beginning of the program and set it to the highest
  1100.  
  1101. possible priority (127) to prevent it from being stolen by other tasks
  1102.  
  1103. requiring audio channels.  However, this method does not take full
  1104.  
  1105. advantage of the audio device's sophistication; it must be remembered that
  1106.  
  1107. in a multitasking environment you have to share resources.  Allocating and
  1108.  
  1109. "holding on" to an audio channel is very uncooperative (and selfish!).
  1110.  
  1111.      The in-line assembly language at the end of the C source code is an
  1112.  
  1113. input handler interface, which is required for the system to "communicate"
  1114.  
  1115. with the custom input handler.  In other words, it copies the appropriate
  1116.  
  1117. system registers (A0 and A1) to the stack to conform with the input handler
  1118.  
  1119. calling convention.  This is absolutely essential if the system is to work
  1120.  
  1121. correctly with the custom input handler.
  1122.  
  1123.      I would like to hear your comments on this program.  Feel free to
  1124.  
  1125. E-Mail me on GEnie (MMD) or Delphi (MOCKO).
  1126.  
  1127.  
  1128.      Note- a simplified version of this program (V1.0) can be found in the
  1129. November 1988 issue of Amazing Computing.  The program as it appears in
  1130. print statically allocates an audio channel, therefore preventing any other
  1131. task in the system from allocating (stealing) it.  This version of the
  1132. program dynamically allocates an audio channel at a priority of -90 each
  1133. time a key is pressed, and works well with other tasks using the audio
  1134. device (at least with my experiences).  This version also adds a toggle
  1135. switch to enable the user to prevent the program from clicking if so
  1136. desired.  If any problems are encountered in using this program, I'd like
  1137. to know so I can upload updated versions. Thank you. -Mike
  1138.  
  1139.  
  1140.  
  1141. *****************************************************************************
  1142.